home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / list556.arc / LIST556.DOC < prev   
Encoding:
Text File  |  1985-12-27  |  10.4 KB  |  252 lines
  1.                                                         LIST     Page 1
  2.  
  3.                         LIST Version 5.56
  4.                 (c) Copyright Vernon D. Buerg 1985
  5.  
  6.  
  7.  Command  LIST
  8.  -------------
  9.  
  10.  Purpose:  To display the contents of an ASCII text file,  line by  line
  11.            with the aid of scrolling and positioning commands.
  12.  
  13.  Format:   LIST  [d:][path]filename[.ext]
  14.  
  15.  Remarks:  An ASCII file of any size may be listed.
  16.  
  17.            The "filename" is optional.  If omitted, you are prompted  to
  18.         to enter  a filename.   You may  include drive,  path, and  wild
  19.         cards in the file name.   The first file which matches  the name
  20.         is displayed until an end-of-file character is encountered. Each
  21.         file which matches the "filename" may be displayed.
  22.  
  23.            LIST was  designed to  display ASCII  files.  That  is, files
  24.         which  contain  text  and  not  binary  or  control codes.  Text
  25.         characters usually range from a value of 32 to 127.
  26.  
  27.            Characters  below  32  (a  blank)  are  replaced with a funny
  28.         character to indicate that a non-displayable character has  been
  29.         encountered.  This character is an upside-down question mark.
  30.  
  31.            Characters above 127 may be valid graphic characters, and may
  32.         be displayed if  the '8' command  is in effect.   To insure that
  33.         characters above ASCII value 127 are not displayed, use the  '7'
  34.         command.
  35.  
  36. |          The top line of the display gives the file name, current right
  37. |       scroll offset, and the file's creation date and time. Optionally,
  38. |       a ruler may be displayed on the top line by using the alt-R keys.
  39.  
  40.            The  file  is  displayed  with  one  logical  record  on each
  41.         80-column display line.   A logical record  ends in a  linefeed.
  42.         The maximum logical record may  be 255 characters long.  If  the
  43.         record exceeds 80  characters, you may  view the portion  beyond
  44.         the 80 columns  by using the  scroll right command,  or by using
  45.         the Wrap feature.
  46.  
  47.            The Wrap  command toggles  ON or  OFF the  wrapping of  lines
  48.         longer than 80 characters.  With Wrap on, lines are displayed in
  49.         their  entirety,  80  characters  per  display line.  The scroll
  50.         -left and -right functions are disabled when Wrap is ON.
  51.  
  52.            The file may  be PRINTed as  it it displayed.   The P command
  53.         toggles  the  printer  on  or  off.   When  first entered, the P
  54.         command causes the current screen  to be printed.  As new  lines
  55.         are displayed, they too are printed.  Printing may be stopped by
  56.         entering another P command.  The PrtSc key may also be used, but
  57.         the title and prompt lines will be printed with the lines of the
  58.         file. Empty lines cause a line to be skipped on the printer.
  59.                                                         LIST     Page 2
  60.  Key functions and Commands
  61.  --------------------------
  62.  
  63.         On the COMMAND line, enter a letter or control key:
  64.  
  65.         Letter(s)     Default   Function
  66.         ---------     -------   ------------------------
  67.         A                       find next occurance of 'text'
  68.         B                       skip to end of file (bottom)
  69.         D or +                  scroll down one page
  70.         F                       Find 'text' regardless of case
  71.         H or ?                  list commands (HELP)
  72.         K               off     toggle keyboard flush
  73.         L                       scroll left 20 columns
  74.         N                       down one (next) line
  75.         P               off     toggle printer on or off
  76.         Q                       display next matching file
  77.         R                       scroll right 20 columns
  78.         S                       Scan for exact text match
  79.         T                       restart from first block (top)
  80.         U or -                  scroll up one page
  81.         W               off     toggle wrap of lines over 80 chars
  82.         X                       terminate, clear screen and exit to DOS
  83.         7               off     turn off high bit (non-graphics only)
  84.         8               on      leave high bit on (graphics)
  85.  
  86.         \text                   Find 'text' regardless of case
  87.         /text                   Scan for exact text match
  88.  
  89.     Control key      Function
  90.     -----------     -------------------------------------------
  91.      Enter           continue to next page
  92.      END             position to end of block
  93.      ESCape          Display next matching file
  94.      HOME            restart from first block (top)
  95.      PgUp            scroll up one page
  96.      PgDn            scroll down one page
  97.  
  98.      left arrow      scroll left 20 columns
  99.      right arrow     scroll right 20 columns
  100.      up arrow        up one (previous) line
  101.      down arrow      down one (next) line
  102.  
  103.      ctl-HOME        restart from CURRENT (64k) block
  104.      ctl-PgUp        restart from first block (TOP)
  105.      ctl-PgDn        skip to end of file (BOTTOM)
  106.      ctl-left-arrow  reset scroll to column 1
  107.  
  108.      F1              Help - display summary of commands
  109.      F3              Find next occurrance of text
  110.      F10             Exit to DOS
  111.  
  112.      F5              change background color for top and bottom lines
  113.      F6              change foreground color for top and bottom lines
  114.      F7              change background color for main body of display
  115.      F8              change foreground color for main body of display
  116.  
  117.      alt-C           clone LIST.COM, change colors permanently in program file
  118. |    alt-R           toggles display of a ruler on the top line
  119.                                                         LIST     Page 3
  120.  
  121.  Screen attributes
  122.  -----------------
  123.  
  124.            The colors used for displaying the titles and main body of
  125.         text may be changed temporarily or permanently. To make a
  126.         permanent change, the cloning command alt-C is used. It requires
  127.         that the LIST.COM program file be on the current drive and in
  128.         the current directory.
  129.  
  130.            There are three classes  of attributes used.  One  for normal
  131.         display lines  - lines  2 to  24 -  another for  special lines -
  132.         lines 1 and 25, and a third for the Find/Scan color.  The border
  133.         is not changed.  The foreground color applies to the characters
  134.         displayed.
  135.  
  136.         These color attributes may be changed by using these function keys:
  137.  
  138.           For the top and bottom lines
  139.             F5 - background color
  140.             F6 - foreground color
  141.  
  142.           For the main body of text
  143.             F7 - background color
  144.             F8 - foreground color
  145.  
  146.  
  147.         Once you have decided upon the colors, use the alt-C key
  148.         combination to change the LIST.COM program file.
  149.  
  150.                                                         LIST     Page 4
  151.  
  152.  Scanning for text
  153.  -----------------
  154.  
  155.  
  156.            You may use  Find (\)  to search for text  regardless  of the
  157.         case, or you may use Scan (/) to find an exact match.
  158.  
  159.            To scan for a character string, type a slash (/) followed  by
  160.         one or more (up to 32)  characters.  The scan text, but not  the
  161.         slash,  is  displayed  on  the  command  line.  The scan is case
  162.         sensitive.  That is, lower case scan text will only match  lower
  163.         lower case file text.
  164.  
  165.            While  the  program  is  searching  for  the text, the bottom
  166.         display line is changed to say "Scanning".
  167.  
  168.            If the text is found, the line containing it is displayed  as
  169.         a high-intensity line.
  170.  
  171.            If the text is NOT found, the bottom line (25) is changed  to
  172.         say '*** text not found ***', and the display remains unchanged.
  173.  
  174.            To find the next occurrance of the same text,  use the A)gain
  175.         command, or press the F3 key.
  176.  
  177.                                                         LIST     Page 5
  178.  
  179. Update history
  180. ==============
  181.  
  182.         Lines beginning with | denote changes to the latest version.
  183.  
  184.         Version 4.1, April 27, 1984.
  185.         Version 4.15, June 2, 1984.
  186.         Version 4.2, July 14, 1984.
  187.         Version 5.0, August 10, 1984.
  188.         Version 5.1, August 27, 1984.
  189.         Version 5.2, September 29, 1984.
  190.         Version 5.4, March 22, 1984.
  191.         Version 5.48, May 27, 1985.
  192.  
  193.         Version 5.49, May 31, 1985.
  194.             Corrects ctrl-PgDn, adds file date/time display
  195.             Wrap forces Left column and Top of file
  196.  
  197.         Version 5.52, July 15, 1985.
  198.             Correct Print command problems
  199.             Adds alt-C to clone LIST.COM with new colors
  200.             The X command now clears the screen when exiting to DOS,
  201.             while F10 leaves the last display on the screen.
  202.  
  203. |       Version 5.56, December 20, 1985.
  204. |           Adds alt-R to toggle a ruler on the top line.
  205. |           Makes LIST compatible with DESQview and TopView.
  206.  
  207.                                                         LIST     Page 6
  208.  
  209.  Restrictions
  210.  ------------
  211.  
  212.            Some positioning is relative to the current block in storage.
  213.         The size of the block depends on the amount of memory available,
  214.         and up to 64K-bytes is allocated to the file buffer. The program
  215.         requires at least 6K bytes.
  216.  
  217.         o  PC-DOS Version 2.0 or later is required.
  218.  
  219.         o  ANSI.SYS is NOT required.
  220.  
  221.  
  222.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 or
  223.         later, including DOS 3.1.
  224.  
  225.         LIST is supplied for personal, private use. Feel free to
  226.         distribute LIST given these restrictions:
  227.  
  228.           o  the program shall be supplied in its original,
  229.              unmodified form, which includes this documentation;
  230.  
  231.           o  no fee is charged.
  232.  
  233.           o  commmercial use is prohibited.
  234.  
  235.           o  the program may not be included - or bundled - with
  236.              other goods or services. Exceptions may be granted
  237.              upon written request only.
  238.  
  239.         If you are using LIST and find it of value, your gift in
  240.         any amount ($15 suggested) will be greatly appreciated.
  241.  
  242.         For use by corporations and other institutions, please
  243.         contact AAI Systems for a site licensing agreement.
  244.  
  245.                 Vernon D. Buerg
  246.                 AAI Systems, Inc.
  247.                 456 Lakeshire Drive
  248.                 Daly City, CA 94015
  249.                 Data: (415) 994-2944 (RBBS)
  250.                 Compuserve: 70007,1212
  251.  
  252.